home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / tshare.arc / HOST.DOC < prev    next >
Text File  |  1985-10-25  |  11KB  |  255 lines
  1.                    /======\
  2.                    | HOST |                    (1.7)
  3.                    \======/
  4.         
  5.             Marty Ross
  6.             c/o Computing Resource Center
  7.             10801 National Blvd., Third Floor
  8.             Los Angeles, CA  90064
  9.  
  10. Release:    1.7, 10/18/85
  11. By:            Marty Ross
  12. System:     IBM-PC with standard communications adapter (COM1:)
  13. Requirements:    Tested using PC-DOS 2.0/2.1, 128K or larger PC preferred.
  14.  
  15. Abstract:    HOST is a communication link which enables your PC to
  16.         act as a 'HOST' to a local or remote terminal, provided
  17.         that your PC is equipped with a communications port, and
  18.         that no full screen, or cursor-oriented video display
  19.         software is used.  Any software which uses the standard
  20.         BIOS routines for keyboard and video I/O (BASIC, therefore,
  21.         is excluded) can be used interactively by a user connected
  22.         via your COM1: or the COM2: adapter.
  23.  
  24. Distribution:    I am distributing this preliminery version freely, in hopes to
  25.         stimulate interest and feedback.  No fee may be charged for its
  26.         distribution, and this document must accompany the programs
  27.         documented herein. 
  28.  
  29. Files:        HOST is distributed in at least two parts: NEW14H.COM, 
  30.         which by itself provides a powerful enhancement to the 
  31.         communication ability of the IBM-PC, and HOST.COM, 
  32.         the application component.  Other optional components
  33.         include TSHARE.COM, the background terminal emulator
  34.         which can be used in tandem with HOST to provide an easy
  35.         "CHAT MODE", or method of accessing your smartmodem.
  36.         Also, WKB.COM, the window keyboard, can be used if desired.
  37.  
  38. Usage:        To use HOST, first make sure that NEW14H has been installed
  39.         on the desired communication port (see NEW14H.DOC), then invoke
  40.         the HOST command, using desired options and correct port, as in 
  41.         the following example:
  42.  
  43.             A>host -p 1
  44.  
  45.         In the above example, we want the "P" option on port 1.
  46.  
  47.         After HOST is active, initialize the port for the desired
  48.         baud and parity settings using the DOS MODE command, then
  49.         use your [PrtSc] key (you may have to hold the shift key down) 
  50.         to toggle the host online or offline.  You can change the
  51.         communication settings or HOST parameters by subsequently
  52.         re-issuing the appropriate DOS commands.
  53.  
  54.         HOST options:
  55.                 K - Keyboard local only. Ignore COM line input
  56.                 P - Pass [PrtSc] key to old function.
  57.                 S - Suppress screen output from this process
  58.                 T - Toggle host online/offline
  59.                 X - Do not touch [PrtSc] key
  60.                 
  61.         I will not go into the details of each here; however, the "P" 
  62.         option may not have an obvious effect: it causes your [PrtSc]
  63.         key to activate not only HOST, but whatever existed as a
  64.         function of that key before HOST was activated.  For instance,
  65.         if TSHARE (the terminal emulator) driver is installed, this
  66.         hookup can cause both HOST and TSHARE to activate/de-activate
  67.         complimentarily, so that the operator can easily toggle from
  68.         online mode to terminal mode ("CHAT" mode) by pressing the
  69.         [PrtSc] key.  
  70.  
  71.         To refresh your memory after learning about HOST, or for
  72.         complete syntax rules for activating HOST, type "HOST ?"
  73.         in DOS for a help screen.  The same applies to the NEW14H 
  74.         program and other related drivers.
  75.  
  76.         There are four steps necessary to activate HOST so that
  77.         it may be used as a terminal emulator:
  78.  
  79.             1.)  Initialize DOS
  80.             2.)  Install the NEW14H communication enhancements
  81.             3.)  Install the HOST application component
  82.             4.)  Initialize the COM: port for desired baud/parity
  83.                  (HOST DOES NOT DO THIS: USE DOS "MODE.COM")
  84.  
  85.         A typical installation sequence (which can be combined into
  86.         a .BAT file, such as "AUTOEXEC.BAT"):
  87.  
  88.  
  89.         +---------------------------------------------------------+
  90.         |                              |
  91.        (1)    |    <ALT>+<CTL>+<DEL> ...                  |
  92.         |                              |
  93.         |    IBM Disk Operating System              |
  94.         |    Version 2.xx ...                  |
  95.         |                              |
  96.        (2)    |    A>new14h                      |
  97.         |    NEW14H - 2.x - (C) Copyright 1985, by Marty Ross  |
  98.         |    Auxiliary COM1: port driver active.          |
  99.         |                              |
  100.        (3)    |    A>host                          |
  101.         |    HOST - 1.x - (C) Copyright 1985, by Marty Ross      |
  102.         |    (Using NEW14H ver 2.x)                  |
  103.         |                              |
  104.        (4)    |          A>mode com1:300,n,8                  |
  105.         |                              |
  106.         |    A>rem HOST can now be activated anytime until     |
  107.         |    A>rem we re-boot (CTL+ALT+DEL), by pressing       |
  108.         |    A>rem '<SHIFT>+[PrtSc]', unless another program      |
  109.         |    A>rem redefines our interrupts.              |
  110.         |                              |
  111.         +---------------------------------------------------------+
  112.                     Figure 1.
  113.     
  114.     Notice that after running the HOST program, we came back to DOS.
  115.     To activate HOST and allow the remote terminal to converse with DOS,
  116.     you must press the <PrtSc> key (may require holding SHIFT down).
  117.  
  118.     You are responsible for establishing your remote connection.  HOST 
  119.     will not interact with a modem in any way.  If you are using a modem
  120.     you must make it answer the phone, and you must ensure that your 
  121.     computer can detect and select the same communication settings as 
  122.     your modem is using.  If you are a programmer, the NEW14H com-
  123.     munication software (which must be active for HOST to function)
  124.     provides you with all the necessary calls for this purpose.  See
  125.     file NEW14H.DOC for the details.  
  126.  
  127.     Once a connection is established and HOST is online, the user on 
  128.     the remote connection should see the same things you see on your local 
  129.     PC-screen.  Again however, this will cease to be the case if software 
  130.     attempts to write to the local screen using direct access or cursor 
  131.     control (such as BASIC).
  132.  
  133.  
  134. Function Keys:    This version of HOST has not been made to understand the
  135.         extended keyboard character set used on the PC.  This means
  136.         that it is impossible for the remote user to generate any of 
  137.         the special (two-character) keyboard codes, such as the F-keys
  138.         INS, DEL, etc.  Half of the responsibility for installing
  139.         this feature lies with the terminal used to attach the remote
  140.         user: it will need to send the same two byte code over the line
  141.         as do the DOS keyboard calls. I plan on getting around to fixing
  142.         this, though it's no priority since I have not found any need
  143.         for it yet.
  144.  
  145.  
  146. Why HOST?:    HOST was written because I needed a better way than PC-DOS'
  147.         'CTTY' command to link my PC up to a phone line in order to 
  148.         start my own Bulletin Board System (BBS).  HOST gives me the
  149.         freedom to allow remote users to access most of the system
  150.         software and in addition, I can easily write and test my
  151.         BBS software: it works with the normal keyboard and screen.
  152.  
  153. Future        Future versions of HOST will necessarily incorporate a 
  154.   Directions:    auto baud rate detection.  Now, the "front end" application 
  155.         program must detect and correct for baud changes, making 
  156.         a single baud rate the desirable alternative.  Also, the
  157.         handling of two byte extended keyboard character codes will
  158.         make the link more complete.  As it stands, no function keys
  159.         can be used by the remote user.
  160.  
  161. Disclaimer:    Though I've tested HOST under varying conditions, I cannot
  162.         guarantee that it will work in every case/PC configuration.
  163.         Also, I suggest you use caution when using HOST in new
  164.         situations (application programs, etc): I will not be liable
  165.         for any damage caused, but would like to be informed if any
  166.         undesireable HOST interactions occur.  Please write me.
  167.  
  168.  
  169. About the Author:
  170.  
  171.         Marty Ross is a consultant for the Computing Resource Center,
  172.         a data processing firm in Los Angeles.  CRC uses the IBM VM/SP
  173.         operating system to provide its clients with an interactive
  174.         method to access popular mainframe data handling facilities, 
  175.         such as SAS, PL/1, FORTRAN, and the On-Line Data System, 
  176.         CRC's own database management product.  For microcomputers,
  177.         CRC has released a Statistics/Data Analysis and Graphics
  178.         package for the IBM-PC called STATA, the Data Tool, which 
  179.         features standard statistical (regression) analyses, excellent 
  180.         data handling capabilities, and a wide variety of experimental
  181.         data analysis techniques with STATA/Graphics.  If you are 
  182.         interested in obtaining a DEMO copy of STATA, please call CRC
  183.         on their toll-free number:  1-800-782-8272 outside California,
  184.         or dial them directly at (213) 470-4341.  Be sure to tell them
  185.         that Marty sent you!
  186.  
  187.  
  188. ----------------------------
  189.  
  190. [1]  NEW14H, and therefore HOST will be destroyed by programs such as BASIC 
  191.      or BASICA which re-define the communication interrupt driver(s).  Also,
  192.      only "nice" programs which do not 'steal' the keyboard, video, PrtSc,
  193.      or timer interrupts may be used successfully with HOST.
  194.  
  195. [2]  Perhaps it is unfortunate that HOST uses the <SHIFT>+[PrtSc] key
  196.      thus disabling it as a "print screen" function.  Remember, however;
  197.      this is only a demonstration program and was not written with profes-
  198.      sional intent.  If enough interest is shown, future versions will 
  199.      be released to those contributing new ideas, free of charge.
  200.  
  201. -----------------------------
  202.  
  203.                    /======\
  204.                    | HOST |                    (1.7)
  205.                    \======/
  206.         
  207.             Marty Ross
  208.             c/o Computing Resource Center
  209.             10801 National Blvd., Third Floor
  210.             Los Angeles, CA  90064
  211.         
  212.             Release:    1.7, 10/18/85
  213.  
  214.  
  215.                 Comments?   
  216.                 Can you use HOST?  
  217.  
  218.  
  219. Name:       _________________________________________________________
  220.  
  221.  
  222. Address:    _________________________________________________________
  223.  
  224.             _________________________________________________________
  225.  
  226.             _________________________________________________________
  227.  
  228.         _________________________________________________________
  229.  
  230.             _________________________________________________________
  231.  
  232.             _________________________________________________________
  233.  
  234.             _________________________________________________________
  235.  
  236.             _________________________________________________________
  237.  
  238.             _________________________________________________________
  239.  
  240.             _________________________________________________________
  241.  
  242.  
  243.     If you feel HOST contributes to your effectiveness, then please let
  244.     me know by sending a donation of $10.00 or whatever you feel is ap-
  245.     propriate.  HOST was developed in my spare time, and is now not a
  246.     commercial effort of CRC.  I will continue to develop products like
  247.     HOST for those who show interest - provided I can afford it.  Users
  248.     who make contributions will be entitled to a single sided diskette
  249.     of other PC-DOS utilities I've developed while at CRC: please include 
  250.     your name and return address when sending donations!
  251.  
  252.     P.S. -  If its the $10.00 that keeps you from filling this out, forget
  253.         about the money, it's the feedback I really want.
  254.  
  255.